//BeanCipher - Bean Cipher Security Layer
//Copyright (C) 2005 Raul Alfredo Bajales
//
//This library is free software; you can redistribute it and/or
//modify it under the terms of the GNU Lesser General Public
//License as published by the Free Software Foundation; either
//version 2.1 of the License, or (at your option) any later version.
//
//This library is distributed in the hope that it will be useful,
//but WITHOUT ANY WARRANTY; without even the implied warranty of
//MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
//Lesser General Public License for more details.
//
//You should have received a copy of the GNU Lesser General Public
//License along with this library; if not, write to the Free Software
//Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
package ar.com.rab.beancipher.spi;

import ar.com.rab.beancipher.spi.exceptions.PropertyCipherException;


/**
 * Do the cipher or decipher operation on a given bean and a given property declared in the property 
 * descriptor passed as argument.
 * 
 * @author Bajales Raul
 */
public interface IPropertyCipher {
    
    /**
     * Cipher the property indicated in the property descriptor (using setter and getter methods
     * references in this descriptor) on the given bean.
     * 
     * @param aBean
     * @param descriptor
     * @throws PropertyCipherException
     */
    public void cipherProperty(Object aBean, IPropertyDescriptor descriptor) throws PropertyCipherException;

    /**
     * Idem cipherProperty(...) but doing the decipher operation.
     * 
     * @param aBean
     * @param descriptor
     * @throws PropertyCipherException
     */
    public void deCipherProperty(Object aBean, IPropertyDescriptor descriptor) throws PropertyCipherException;
}
